Tables > Uniform Data Codes > System UDCs > UIS System UDCs

UIS System UDCs

System UDCs facilitate system-level supervision of specific data points. The UDCs listed here are classified topically and include descriptions, keywords, and function.

For example, you could create a point record in the Point Service (PNT) that includes the UDC SYCSSTP. SYCSSTP would then send a notification if the percentage of successful messages on a serial radio communication device dropped below 95%.

See the following subsections for more information:

For general information about system UDCs, see System UDCs.

Suffixes

Many of the UDCs listed here can include a suffix that constrains the amount of data collected by the UDC. The constraint is time based. You could append any of these values to the end of the UDC to provide such a constraint: 2M, CD, CH, CM, LD, LH, LM, where 2M means 20 minutes, CD means current day, CH means current hour, CM means current month, LD means last day, LH means last hour, and LM means last month.

Communication Device Failover

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type
Comm failover of primary SYDEVFO1   Updates whenever the primary communication device fails over to one of the alternate devices.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service. Analog Input
Comm failover of secondary SYDEVFO2   Updates whenever the secondary communication device fails over to one of the alternate devices.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service. Analog Input
Comm failover of tertiary SYDEVFO3   Updates whenever the tertiary communication device fails over to one of the alternate devices.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service. Analog Input
Primary Comm Failover SYDEVPRFO   This point is set to 1 whenever the RTU has failed over from primary to secondary based on the Init Fail Secs setting. It is not reset to 0 until there is successful communication with the primary communication device.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service. Analog Input
Back to top

Device Settings

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Comm Device Host Mode

SYDEVHMODE

 

The host mode of the communication device.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

TBD

Device Category

SYDEVCAT

 

The device category (RD, CD, ED) in string format.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Device Enabled

SYDEVENABL

 

Indicates if device is enabled in the DDS (1=enabled; 0=disabled).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Digital Input

Device Poll Attempts

SYDEVRETRY

 

The number of poll attempts.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Device Poll Delay

SYDEVPDELY

 

The message delay in milliseconds.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Device Poll Timeout

SYDEVPTOUT

 

The message timeout in milliseconds.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Device Revision

SYDEVREV

 

The software revision number of the RTU. Posted by the EIE only if the point is defined. Only implemented for the following EIEs: AllenBradleyCIP, EProd, FlowAuto, Weatherford, LufkinSam, Mercury, and ProSoft.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Last User to Poll/Ctrl

SYLASTUSR

 

The last user to send/retrieve data from device/facility.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Number of Configured Comms SYDEVCOMN  

Represents the number of configured comm lines for a given remote device. The value can be 1, 2, or 3.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Back to top

Identifiers: Communication Devices

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Alternate Comm 2

SYDEVACOM2

 

The name of the configured secondary communication device. Can be used interchangeably with SYDEVSCOM.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Alternate Comm 3

SYDEVACOM3

 

The name of the configured tertiary communication device.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Curr Comm Line

SYDEVCOMLN

 

The currently active communication line. 1 for primary, 2 for secondary, 3 for tertiary.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Device Comm ID

SYDEVCOMID

 

The device ID of the currently active communication device in string format.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Primary Comm ID

SYDEVPCOM

 

The name of the configured primary communication device.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Secondary Comm ID

SYDEVSCOM

 

The name of the configured secondary communication device. Can be used interchangeably with SYDEVACOM2.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Back to top

Identifiers: Remote Devices

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Device Address

SYDEVADDR

 

The device address (including group address if applicable) in string format.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Device Desc

SYDEVDESC

 

The device description in string format.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Device ID

SYDEVID

 

The device ID in string format.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Device Type

SYDEVTYPE

 

The device type (based on EIE) in string format.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Back to top

Modems

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Dial Attempts

SYCSMDAT *

 

The number of total dial attempts (successful and failed).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Dial Attempts Failed Busy

SYCSMDBY *

 

The number of failed dial attempts due to busy signal.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Dial Attempts Failed Unknown

SYCSMDUK *

 

The number of failed dial attempts due to unknown reasons.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Dial Attempts Fail No Carrier

SYCSMDNC *

 

The number of failed dial attempts due to no carrier.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Dial Attempts Fail No Dial tone

SYCSMDND *

 

The number of failed dial attempts due to no dial tone.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Dial Attempts Successful

SYCSMDOK *

 

The number of total successful dial attempts.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Dial Retry Attempts

SYCSMDRA *

 

The number of total dial retries.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Last Dial Attempt Time

SYCSMDDT *

 

The time of last dial attempted (failed or succeeded) (MM/DD hh:mm:ss format).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Modem Connect Error

SYCSMDER *

 

The modem connect failures reported as Error.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Modem Connect No Answer

SYCSMDNA *

 

The modem connect failures reported as No Answer.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Back to top

Polling: Failure

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Consecutive Fld Msgs

SYCSFSEQ *

Consecutive Failures

The number of consecutive failed communication attempts.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Last device to fail

SYC

 

Tracks the remote device that last had a failed message on a communication device. The comm device stores the remote ID and the current time when failures occur. The point will only update if the remote ID is not empty and the latest failure timestamp has changed.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device.

String Input

Last Fld Com Desc

SYCSLFCD *

Last Failed Desc

The last failed communication message (name of message in text).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Last Fld Com Time Num

SYCSLFCN *

 

The time of last failed communication (OLE date/time format in GMT).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Last Fld Com Time Text

SYCSLFCT *

Last Failed Time

The time of last failed communication (MM/DD hh:mm:ss format).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Lst Fld UIS Desc

SYCSLFUD *

Last Failed UIS Desc

The name of last failed UIS command.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Lst Fld UIS DevId

SYCSLFUI *

Last Failed UIS DevId

The device ID that the last failed UIS command was sent to.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Lst Fld UIS Tm N

SYCSLFUN *

 

The time of last failed UIS command (OLE date/time format in GMT).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Lst Fld UIS Tm T

SYCSLFUT *

Last Failed UIS Time

The time of last failed UIS command (MM/DD hh:mm:ss format).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Sec Lst Fld Comm

SYCSLFCS

Secs Since Failure

The elapsed time (in seconds) since the last failed communication. Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Points using this UDC update in the following conditions:

Analog Input

Ttl Fld Msgs

SYCSFTOT *

Failed Msgs

The number of total failed messages for all reasons.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Fld Msgs CRC

SYCSFCRC *

Failed CRC

The number of total failed messages due to CRC error.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Fld Msgs No Resp

SYCSFNOR *

Failed No Resp

The number of total failed messages due to no response.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Fld Msgs Other

SYCSFOTH *

Failed Other

The number of total failed message other than CRC or no response.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Fld UIS Cmds

SYCSFUTT *

Failed UIS Cmds

The number of total failed UIS commands.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Back to top

Polling: Success

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

# Succ Msgs 1st Att

SYCSS1N *

Success 1st Att

The number of successful messages on the first attempt.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

# Succ Msgs Nth Att

SYCSSNN *

Success Nth Att

The number of successful messages on attempts subsequent to the first.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

# Succ Msgs Ttl

SYCSSTN *

Success Msgs

The number of total successful messages.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

% Succ. 0 Attempts is Reliable

SYCSSTZR

 

Determines whether to mark the Percent Successful Communication statistic as reliable or unreliable when the attempts count is zero. Default is mark point as reliable.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

% Succ Msgs 1st Att

SYCSS1P *

Percent 1st Att

The percentage of successful messages on the first attempt.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

% Succ Msgs Nth Att

SYCSSNP *

Percent Nth Att

The percentage of successful messages on attempts subsequent to the first.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

% Succ Msgs Ttl

SYCSSTP *

Success %

The percentage of successful messages.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Avg Succ Resp Time

SYCSAPRT *

Avg. Resp Time (ms)

The average successful response time in milliseconds.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Last Succ Resp Time

SYCSLPRT *

 

The number of milliseconds for last successful response.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Last Succ Com Desc

SYCSLSCD *

Last Succ Desc

The name of last successful message.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Last Succ Com Time Num

SYCSLSCN *

 

The time of last successful communication (raw UTC time).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Last Succ Com Time Text

SYCSLSCT *

Last Succ Time

The time of last successful communication (MM/DD hh:mm:ss format, local system time).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Lst Succ UIS Desc

SYCSLSUD *

Last Succ UIS Desc

The name of last successful UIS command.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Lst Succ UIS DevId

SYCSLSUI *

Last Succ UIS DevId

Device ID that the last successful UIS command was sent to.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Lst Succ UIS Tm N

SYCSLSUN *

 

The time of last successful UIS command (OLE date/time format in GMT).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Lst Succ UIS Tm T

SYCSLSUT *

Last Succ UIS Time

The time of last successful UIS command (MM/DD hh:mm:ss format, local system time).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Sec Lst Succ Comm

SYCSLSCS

Secs Since Success

Elapsed time (in seconds) since the last successful communication.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Points using this UDC update in the following conditions:

Analog Input

Succ Bytes Rcvd: Total

SYCSSBRC *

 

The number of successful bytes received.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Succ UIS Cmds

SYCSSUTT*

Success UIS Cmds

The number of total successful UIS commands.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Value for %Succ. For 0 Attempts

SYCSSTZA

 

Determines the value to use in calculating the percent successful when the attempt count is zero. Default is 100.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Back to top

Polling: Transmission

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Lst Dev Drain Tm N

SYCSLDDN *

The last time it was necessary to clear unexpected data from communications channel (OLE date/time format in GMT).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Lst Dev Drain Tm T

SYCSLDDT *

Last Device Drain

The last time it was necessary to clear unexpected data from communications channel (MM/DD hh:mm:ss format).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Lst Drain DevID

SYCSLDDI *

Last Drain DevId

The last device attempted to be communicated with when it was necessary to clear unexpected data from the communication channel.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

String Input

Last Message Sent Desc

SYCSLBCD *

 

The name of the last message sent (failed or succeeded).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Last Message Sent Time

SYCSLBCT *

 

The time of last message sent (failed or succeeded) (MM/DD hh:mm:ss format).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Ttl Atmpd Msgs

SYCSTOT *

Msg Attempts

The number of total attempted messages.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Atmpd UIS Cmds

SYCSUTT *

 

The number of total attempted UIS commands (sum of SYCSSUTT and SYCSFUTT).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Bytes Drained

SYCSDDB *

 

The total unexpected bytes cleared from the communication channel.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Ttl Bytes Rcvd

SYCSBRCV *

Bytes Received

The number of total bytes received.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Bytes Sent

SYCSBSNT *

Bytes Sent

The number of total bytes sent.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Ttl Device Drains

SYCSDDTT *

Total Device Drains

The number of times unexpected data needed to be cleared from the communication channel.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device or Facility Service (FAC). A FAC facility is defined using the format Site_Service.

Analog Input

Back to top

Queue Status

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Avg Resp Proc. Time

SYMSARPT

 

The average number of milliseconds to process an item in the processing queue.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable UIS. A UIS facility is defined using the format Site_Service.

Analog Input

Avg Ttl Mess Proc. Time

SYMSATMT

 

The average number of milliseconds to process all items in the processing queue.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable UIS. A UIS facility is defined using the format Site_Service.

Analog Input

Pending Comm Queue Cnt

SYCSPEND

 

The number of messages pending in a communication queue.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device.

Analog Input

Pending Comm Queue Cnt per Remote Device

SYRSPEND

The number of messages the specified remote device has pending in its associated communication queue.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable remote device.

Analog Input

Point Value Only Resp Queue

SYPROCQPT

 

Represents the size of the Point processing queue.

This UDC tracks process messages which do just point processing. Allows tracking of the backlog of the Point processing queue.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable UIS. A UIS facility is defined using the format Site_Service.

Note: Some messages which write to the DDS may end up on the Point Processing response queue and vice-versa.

Analog Input

Processing Queue Count

SYPROCQUE

 

The number of messages in the UIS processing queue (non-communications related). Examples are device and point updates. Represents the sum of SYPROCQPT and SYPROCQTX. Generally this value is best kept to less than 2.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable UIS. A UIS facility is defined using the format Site_Service.

Analog Input

Tx Writing Resp Queue

SYPROCQTX

 

Represents the size of the DDS transaction processing queue. This UDC tracks process messages which will save transaction data to the DDS. Allows tracking of the backlog of the DDS transaction processing queue.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable UIS. A UIS facility is defined using the format Site_Service.

Note: Some messages which write to the Point Processing response queue may end up on the DDS transaction processing queue and vice-versa.

Analog Input

Back to top

State: Communication Devices

The following UDCs provide system-level information.

UDC Description UDC UI Description Description Point Type

Activate 20 Min. Stats

SYCSST2M

 

Activates the use of 20-minute statistics, which is a special rollup of one-minute values for the 20 minutes prior to execution. It helps control the strain that constant recalculation would ordinarily put on a large system.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

20-minute statistics are not represented as current period-last period pairs; there is no previous statistic to compare against the current one. For each minute that passes, the rollup is recalculated with the oldest value dropped off and the most recent value added on. There is no dynamic processing of the 20-minute statistic in between the one-minute processing intervals even if the statistic's point processing is forced by the device.

Activating the UDC for your UIS and selected devices does not enable mapping for the UDC. To enable mapping, you must add specific points by using the appropriate communication statistics system UDC(s) along with the required time period suffix.

20-minute statistics are applicable to communication and remote devices.

For more information, see Setting Up 20-Minute Statistics.

String Input

Comm Device State Numeric

SYDVST8N

The communication device state in numeric format. Applies only to the communication device.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device.

Return values are:

  • 04 - Connected
  • 05 - Not Connected
  • 06 - Paused
  • 07 - Error
  • 08 - Disabled
  • 09 - Connecting
  • 10 - IP Connecting
  • 11 - IP Connected
  • 12 - Modem Connecting
  • 13 - Modem Connected
  • 14 - Not Ready

Analog Input or Enum Input

Comm Device State Text

SYDVST8S

The communication device state in string format. Applies only to the communication device.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device.

Return values are:

  • Connected
  • Not Connected
  • Paused
  • Error
  • Disabled
  • Connecting
  • IP Connecting
  • IP Connected
  • Modem Connecting
  • Modem Connected
  • Not Ready

String Input

Cryouts: Total

SYCSCRY *

Cryouts

The number of total cryouts.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Curr Active Device

SYCSRDVC

 

The name of the currently active device. Name is displayed only when device is active; otherwise the value is blank.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Curr Com State Num

SYCSSTTN *

 

Specifies the state of a device communication channel. Applies to both remote devices and communication devices.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

The following values are possible:

  • 00: Assigned if no message has occurred since a UIS start.
  • 01: Assigned if a successful message is the most recent message to occur.
  • 02: Assigned if a failed message is the most recent message to occur.
  • 03: Assigned if a failed message is the most recent message to occur and the interval (in minutes) between the most recent failed message and the previous successful message or UIS start (if no successful message exists since UIS start) exceeds the value specified for SYCOMSTFP.

If using an enumeration input point type, use the COMSTATE table for the conversions.

See Failed Comm Transition Period for information about when 2 – Exception changes to 3 – Critical.

For strings, see SYCSSTAT.

Analog Input or Enum Input

Curr Com State Text

SYCSSTAT *

 

Specifies the state of a device communication channel. Applies to both remote devices and communication devices.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

The following values are possible:

  • Unknown: Assigned if no message has occurred since a UIS start.
  • Normal: Assigned if a successful message is the most recent message to occur.
  • Exception: Assigned if a failed message is the most recent message to occur.
  • Critical: Assigned if a failed message is the most recent message to occur and the interval (in minutes) between the most recent failed message and the previous successful message or UIS start (if no successful message exists since UIS start) exceeds the value specified for SYCOMSTFP.

See Failed Comm Transition Period for information about when 2 – Exception changes to 3 – Critical.

For enumerations, see SYCSSTTN.

String Input

Failed comm transition period

SYCOMSTFP

Specifies the interval (in minutes) allowed before a communication state changes from 2 – Exception to 3 – Critical. The interval starts at the most recent failed message and extends to the previous successful message or UIS start (if no successful message exists since UIS start).Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable UIS. A UIS facility is defined using the format Site_Service.

The interval is not tied to current time. For example, imagine you set SYCOMSTFP to 20. A successful message occurs at 3:00:00AM and the comm state becomes Normal. Then no other message occurs until 3:10:00AM, when a failed message occurs and the comm state becomes Exception. At 3:45:00AM a second failed message occurs, which changes the comm state from Exception to Critical. That is because the Exception state was reached and more than 20 minutes passed since the last successful message. The change does not occur at 3:20:00AM or 3:40:00AM.

You can apply the value to a remote device, communication device, and/or an entire UIS. If you apply this value to a remote device, the value applies to all of the remote device’s facilities. If you apply this value at the UIS level, it applies to all remote devices and communication devices in that UIS. The default value at the UIS level is 480.

To change the interval for the UIS, create a point for which the facility is the applicable UIS and the UDC is SYCOMSTFP.

To change the interval for a device, create a point for which the facility is the applicable device and the UDC is SYCOMSTFP.

An edit to this setting does not take effect until a UIS start occurs.

See Failed Comm Transition Period for information about when 2 – Exception changes to 3 – Critical.

Analog Input

Last Active Device

SYCSRDVL

 

The name of the last active device.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

String Input

Not Ready Events

SYCSSTNR *

 

The current value of the consecutive Not Ready event counter.Click hereWhen configuring a point to use with this UDC, ensure that the service used is the applicable UIS and that the facility ID is that of the applicable communication device, remote device, or facility linked to a remote device.

Analog Input

Back to top

Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.